home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL / glutessnormal.z / glutessnormal
Encoding:
Text File  |  2002-10-03  |  3.3 KB  |  67 lines
  1.  
  2.  
  3.  
  4. gggglllluuuuTTTTeeeessssssssNNNNoooorrrrmmmmaaaallll((((3333GGGG))))              OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee              gggglllluuuuTTTTeeeessssssssNNNNoooorrrrmmmmaaaallll((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      gggglllluuuuTTTTeeeessssssssNNNNoooorrrrmmmmaaaallll - specify a normal for a polygon
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void gggglllluuuuTTTTeeeessssssssNNNNoooorrrrmmmmaaaallll( GLUtesselator* _t_e_s_s,
  14.                          GLdouble _v_a_l_u_e_X,
  15.                          GLdouble _v_a_l_u_e_Y,
  16.                          GLdouble _v_a_l_u_e_Z )
  17.  
  18.  
  19. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  20.      _t_e_s_s    Specifies the tessellation object (created with gggglllluuuuNNNNeeeewwwwTTTTeeeessssssss).
  21.  
  22.      _v_a_l_u_e_X  Specifies the first component of the normal.
  23.  
  24.      _v_a_l_u_e_Y  Specifies the second component of the normal.
  25.  
  26.      _v_a_l_u_e_Z  Specifies the third component of the normal.
  27.  
  28. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.      gggglllluuuuTTTTeeeessssssssNNNNoooorrrrmmmmaaaallll describes a normal for a polygon that the program is
  30.      defining.  All input data will be projected onto a plane perpendicular to
  31.      one of the three coordinate axes before tessellation and all output
  32.      triangles will be oriented CCW with respect to the normal (CW orientation
  33.      can be obtained by reversing the sign of the supplied normal). For
  34.      example, if you know that all polygons lie in the x-y plane, call
  35.      gggglllluuuuTTTTeeeessssssssNNNNoooorrrrmmmmaaaallll(tess, 0.0, 0.0, 1.0) before rendering any polygons.
  36.  
  37.      If the supplied normal is (0.0, 0.0, 0.0) (the initial value), the normal
  38.      is determined as follows. The direction of the normal, up to its sign, is
  39.      found by fitting a plane to the vertices, without regard to how the
  40.      vertices are connected. It is expected that the input data lies
  41.      approximately in the plane; otherwise, projection perpendicular to one of
  42.      the three coordinate axes may substantially change the geometry. The sign
  43.      of the normal is chosen so that the sum of the signed areas of all input
  44.      contours is nonnegative (where a CCW contour has positive area).
  45.  
  46.      The supplied normal persists until it is changed by another call to
  47.      gggglllluuuuTTTTeeeessssssssNNNNoooorrrrmmmmaaaallll.
  48.  
  49. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  50.      gggglllluuuuTTTTeeeessssssssBBBBeeeeggggiiiinnnnPPPPoooollllyyyyggggoooonnnn, gggglllluuuuTTTTeeeessssssssEEEEnnnnddddPPPPoooollllyyyyggggoooonnnn
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.